lcDrwAddBlockFile

Creates a block from an external drawing file. "Model Space" block of the external drawing will be copied into the specified block.
If the "Model Space" has references to other blocks, then they also will be copied.

HANDLE lcDrwAddBlockFile (
   HANDLE hDrw,
   LPCWSTR szName,
   LPCWSTR szFileName,
   int Overwrite,
   HWND hWndParent
);

Parameters

hDrw

Handle to a drawing object.

szName

Block name. If the block already exist in the drawing hDrw, it will be overwritten, depend on the Overwrite parameter.

szFileName

The filename of another drawing. The drawing must have any of supported file format.

Overwrite

Overwrite mode. Defines LiteCAD behaviour if copied block already exist in the drawing. Can be one of the following constants:

Value	Meaning
LC_BLOCK_OVERWRITENO	Do not overwrite exist block
LC_BLOCK_OVERWRITEYES	Always overwrite exist block
LC_BLOCK_OVERWRITEDLG	Display a dialog, where a user can choose an option.

hWndParent

Handle to a parent window for the "Overwrite block" dialog. Specify NULL if the LC_BLOCK_OVERWRITEDLG mode is not used.

Return Value

Handle to a new block.
If the function fails, the return value is NULL.

Remarks

If the copied block has references to other blocks, then they also will be copied. Also will be copied all referenced named objects, like layers, linetypes, text stylles, etc.